home *** CD-ROM | disk | FTP | other *** search
/ Archive Magazine CD 1995 / Archive Magazine CD 1995.iso / discs / prog_disc / volume_8 / issue_09 / std / !STDFinder / Readme < prev    next >
Encoding:
Text File  |  1995-03-28  |  9.8 KB  |  258 lines
  1. ############################################################
  2. #                    !STDFinder V2.00                      #
  3. #     By Julyan Bristow August 1993 - June 1993            #
  4. ############################################################
  5.  
  6. ReadMe file for !STDFinder
  7.  
  8. 1.0 Introduction
  9. ################
  10.  
  11. The purpose of this program is to allow users to match towns
  12. with their STD dialling codes, and vice versa.  Wildcard
  13. matching is allowed, and export of the entire database, or a
  14. subset is allowed.  Editing of the data through addition or 
  15. deletion of database entries is allowed.
  16.  
  17. 2.0 The Program
  18. ###############
  19.  
  20. The program installs on the icon bar in the normal way.
  21. Three options are currently available from the icon bar
  22. menu:
  23.  
  24.         Info            Self explanatory
  25.         Search            "    "     "
  26.         Quit              "    "     "
  27.  
  28. 2.1 'Info'
  29. ##########
  30. Clicking or following the arrow gives the usual information
  31. on version number and author of the program.
  32.  
  33. 2.2 'Search'
  34. ############
  35. Clicking on the icon itself, or selecting this option from
  36. the menu allows searching of the STD Code 'database'.  This
  37. pops up a dialogue box with 3 menu items, 1 entry field, 2 
  38. output fields, 2 arrow icons and a selectable exact option. 
  39.  
  40. The town or code to be found should be entered in the box
  41. under the menu icons as indicated.
  42.  
  43. To commence the search, either click with the left mouse
  44. button over the 'Search' icon, or press return.  If none 
  45. are found, a beep will sound.  If the search criteria is met,
  46. then those towns and codes meeting the search criteria will 
  47. appear in a window below, which can be scrolled to view all
  48. entries, should there be more than the number appearing in the
  49. window.
  50.  
  51. Selection of the 'exact' option means that the database will be
  52. searched only for an exact match of the user's search string.
  53. Eg if the search string is 'Bedworth', then only matches exactly
  54. equal to this will be identified.  This the same for the dialling
  55. codes
  56.  
  57. If the exact option is not selected, then a match will be found 
  58. if the users search string is contained within any of the entries 
  59. of the database.  This is case independent.  Eg if the search 
  60. string is 'worth', then 'Bedworth', 'Bagworthy' and 'Worthing'
  61. will all be valid.
  62.  
  63. Use of Wildcards (v0.09 onwards):
  64. A simple wildcards search is now permitted.  The wildcard symbol 
  65. is '*'.  Wildcards are currently used (v0.09) to determine whether
  66. the search is to be from the start or the end each of the database
  67. strings.
  68.  
  69. To clarify this consider, the search string 'worth' once again.
  70. If 'worth' is entered then the results will be similar to those 
  71. described above.  However, if 'worth*' is entered then only towns
  72. beginning with the string worth will be found Eg Worthing.  If 
  73. '*worth' is entered then only towns with the last 5 characters of 
  74. worth will be found Eg Bedworth.  Finally if *worth* is entered 
  75. then only towns containing the 5 characters 'worth' in their name, 
  76. but not at the start or end will be found Eg Bagworthy.
  77.  
  78. If wildcards are not positioned in the first or last position 
  79. of the search string, or there are more than 2 wildcards
  80. entered, then an error will be reported (most of the time!) and 
  81. at the very least no string will be found.
  82.  
  83. Wildcards are not permitted with the exact option set to on.
  84.  
  85. Clicking 'menu' over this window gives two further options - Edit 
  86. and Save, each with a further submenu.
  87.  
  88. The Edit option submenu allows addition of new data and deletion of
  89. existing data.  Selection of either of these will pop up a second
  90. dialogue box containing 3 fields for entry of the town, its code 
  91. and a menu icon to carry out either the deletion or addition.  
  92. Currently, this dialogue box will not move, neither will the cursor
  93. keys move the text caret, so you will have to use the mouse.  I am 
  94. currently looking into this.
  95.  
  96. Addition of a new entry will always enter the text string into the 
  97. format 'Xxxxx Xxxxxx Xx Xxxx' depending on the number of words to be
  98. entered. Eg wOrhTinG is entered as Worthing.  The new entry is 
  99. added in sorted order, so if the data is to be used elsewhere there
  100. is no need to sort it before use.
  101.  
  102. On deletion, only an exact match of both the town and the code will
  103. allow deletion of the entry.
  104.  
  105. The Save option submenu gives two choices.  The first is to save the
  106. entire database to a text file.  The second is to save all the entries
  107. found after a search to a text file.  This option is disabled if there
  108. are no entries found.
  109.  
  110. 2.4 'Quit'
  111. ##########
  112. Select this to quit the program.  A check is made to ensure that any
  113. additions or deletions to the database will be saved at the users 
  114. discretion.
  115.  
  116. 2.5 'Load User Directories'
  117. ###########################
  118. Option added at version 1.00. The user may add their own data to the
  119. program.  This is done by dragging a text file to the icon on the icon
  120. bar.  This will pop a dialogue box to give the user the oppotunity to 
  121. append the data, or overwrite the current data, or to cancel if required.
  122. The data is sorted as it is added to the database, and so can take some
  123. time if large datafiles are added.
  124.  
  125. The file format is as follows: A text file, with the town name followed
  126. a comma, followed by the code. The last line of the file should be data, 
  127. and there should be no blank line. 
  128.  
  129. 3.0 Program Limitations
  130. #######################
  131. Wildcard option a bit simple.
  132. Does not fully release memory at the start of each
  133. newsearch.
  134.  
  135. 4.0 Proposed Program Enhancements
  136. ##################################
  137. Proposed enhancements are as follows:
  138. (i)     Compression of the database for smaller overall program disk
  139.         space.
  140. (ii)    Use flex.h or heap.h to use memory releasing routines.
  141.  
  142. 5.0 Version History
  143. ###################
  144. Version 0.01: August 1992
  145. Initial version of the program working in a desktop
  146. enviroment.  'Info', 'Search' and 'Quit' routines
  147. implemented with a limited database.
  148.  
  149. Version 0.04: September 1992
  150. Tidying up of code of version 0.01.  All STD codes entered
  151. into database.
  152.  
  153. Version 0.05: 25 September 1992
  154. Further coding improvements.  Facility added to make search
  155. criteria case independant. Eg LonDoN will now be found.
  156.  
  157. Version 0.06: 2 October 1992
  158. Further coding improvements. Bubble sort routine added to
  159. sort database either by code or by town.  Export routine
  160. included to allow easy export of the sorted data to !EDIT,
  161. printers etc.
  162.  
  163. Version 0.07: 2 October 1992
  164. Replaced bubble sort with the quick sort algorithm.
  165.  
  166. Version 0.08: 23 December 1992
  167. Added faded arrow fields. Added exact search option, and changed
  168. existing search option to allow the search string to be found if it
  169. is contained in any of the database entries.  Removed radio icons 
  170. for selection of search by town or code - difference automatically
  171. detected.
  172.  
  173. Version 0.09: 31 December 1992
  174. Added a relatively simple wild card search option. Attempted to
  175. make the exact search detection a bit more robust.
  176.  
  177. Version 0.10: 9 January 1993
  178. Improved robustness of exact icon operation and allowed the 
  179. RETURN key to start the search after entry of the code or town.
  180. Thanks to Craig Murphy and Shanawaz Basith for the tips for the above.
  181.  
  182. Version 0.16: 23 February 1993
  183. Temporary removal of sort option.  Change program to use doubly linked
  184. dynamic lists (no restriction other than memory on database or search
  185. sizes). Addition of menu structure to the search window.  Addition of 
  186. add and delete database entries.  Addition of save complete database and
  187. save searched subset.
  188.  
  189. Version 1.00: 8 March 1993
  190. Added features: drag user directory to database - append or overwrite.
  191. Check before quitting if need to save any new data.
  192. Fully released into public domain.
  193.  
  194. Version 1.01: 22 March 1993
  195. Error in saving modified database data corrected. When saving data 
  196. from the search menu, width of town now determined by maximum length 
  197. of data read in, so town name is never truncated.
  198.  
  199. Version 2.00: 16 June 1993
  200. All towns meeting the search criteria now displayed in a window.
  201.  
  202. Version 2.01: 22 February 1995 Recieved new codes for Phoneday from
  203. Ted Lacey (including some corrections due to changes by BT).  Altered
  204. code to read this file (Newcodes) as default directory.
  205.  
  206. Version 2.02: 28 March 1995
  207. Received codes for London exchanges and international codes from
  208. Frank Peddie.  Allowed a full 8 character code eg 0121_745 to be
  209. entered (not permitted in earlier versions).
  210.  
  211. 6.0 Notes #########
  212.  
  213. On orginal release, this program had the correct codes in
  214. the directory.  Due to Phoneday in April 1995 a lot of these
  215. codes are now dofferent.  My thanks go to Ted Lacey for his
  216. efforts in providing a correct directory for Phoneday. 
  217. Please see STDReadme for further information.
  218.  
  219. I believe this application works on a Risc PC, although I
  220. don't have one myself.
  221.  
  222. This program is Public Domain.  Please feel free to
  223. distribute it as you wish. Please make sure that all the
  224. files listed below are included:
  225.  
  226.         !Boot
  227.         !Run
  228.         !Runimage       The executable code
  229.         !Sprites        The application sprites
  230.         Sprites         The resource sprites 
  231.         Templates       The application template file
  232.         Newcodes        The database of all STD codes
  233.         Directorys      Directory containing various
  234.                         different STD Code directories.
  235.         ReadMe          This file
  236.         STDReadme       Readme file from Ted Lacey
  237.                         for Phoneday codes
  238.  
  239. Please do not take credit where it is not due!  It took me
  240. hours to type in all the codes (all 5000+ of them) so at 
  241. least give me some credit. I was going to encode the data,
  242. but it is not really worth all that much bother, so please
  243. do not abuse my trust.
  244.  
  245. However, I will be very grateful if any mistakes are
  246. highlighted and sent to me at the address below, so that
  247. any future versions will contain fewer errors.  Also if
  248. anyone can think of better sprite then please send it in - I
  249. am useless at drawing. Credit will be given as apropriate.
  250.  
  251. Please write to 
  252.  
  253.         Julyan Bristow
  254.         40 Dunard Road
  255.         SHIRLEY
  256.         SOLIHULL
  257.         WEST MIDLANDS
  258.         B90 2HR